Skip to main content
Version: 2.2.1

Examples of widget creation - simple widget

Number of security incidents in last 24h - example assumptions​

We want to create a widget that displays the number of security incidents in the last 24 hours.

Implementation​

  1. Widgets are created and edited in the menu [Dashboard>Management>Widgets].

image-20220704110915152

  1. To add a widget, click on the Add Widget button, then the widget wizard will appear.

image-20220704111118805

  1. In the Visualization Tab, enter the name of the Widget in the field Title. In addition to entering a name, you can enter a short description of the Widget in the field Description and assign Tags. Now it is necessary to select the type of visualization you want to use. In this example it will be KPI.

image-20220620103155525

As we know, the widget creation process is divided into three tabs:

  • Visualisation,
  • Data,
  • Option.

image-20220620105022147

  1. Change the tab to Data.

image-20220905152327228

  1. In order to count the number of alarms, you need to choose a data stream from which such information can be obtained. Information about security incidents are contained in the Alerts stream, which must be selected in the Source field.

image-20220905152556708

  1. Specify the time period for which Widget will analyze data - in our example it is last 24h.

image-20220905152819668

  1. Define an Aggregation that will allow you to calculate the number of unique alerts that have been generated. To do this, select field Alert id in the Metrics and Unique count in the Aggregation. Alert id is a Field in the Alerts Data Stream that stores the unique id of the alert and Unique Count is an aggregation that returns count of unique non empty fields.

image-20220905153016355

image-20220905153119253

image-20220704113152023

  1. At this point the widget in its simplest form is almost ready, but it can be edited in various ways to suit individual preferences. As you can see our Widget counted 4296 security incidents in the last 24h. To save the Widget, use the Create button, then it appears on the list of widgets and is ready to be used as part of the Dashboard.

image-20220905153339735

Visual tuning​

  1. Change the tab to the Options and add an icon to the number displayed and to allow other users to launch the widget.

image-20220905153823803

In the KPI icon section there are many icons to choose, in the example let’s choose the Warning sign icon. The result looks like this:

image-20220905154039173

image-20220905154004236

Changing widget permissions​

  1. Change the tab to the Options. By default, the Widget has permission settings as Private.

image-20220905144907213

If you want other users to be able to use the Widget, change its permissions to Public.

image-20220905145018349